home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / program / 619 / pas_xref / pas_xref.asc < prev    next >
Encoding:
Text File  |  1992-08-02  |  3.7 KB  |  88 lines
  1.                Pascal Cross Reference Generator (PCRG)
  2.               Freeware by Paul Lefebvre and Julian Garza
  3.                       Written in Personal Pascal
  4.                    July 25-August 2, 1992  (c) 1992
  5.                                FREEWARE
  6.  
  7.      I wish to thank Mr. Garza for posting the original version of 
  8. this cross reference generator in the public domain.
  9.  
  10.      The cross reference portion of this program is taken from 
  11. ALGORITHMS + DATA STRUCTURES = PROGRAMS by Niklaus Wirth.
  12.  
  13.      The resource was created with the Orcs Resource Contruction Set.
  14.  
  15.  
  16.      There are two versions of PCRG include in the LZH :
  17.  
  18. PAS_XREF.ACC   : This is the accessory version with an internal 
  19.                resource.  It will also run as a program if you rename 
  20.                it to PAS_XREF.PRG, but it will not accept a command 
  21.                line and has the same limited stack as the accessory 
  22.                (about 30K).  If you get a 'Stack overruns heap' 
  23.                message while xreffing a large file, switch to the stand-
  24.                alone version to create the xref.
  25.  
  26. PAS_XREF.PRG   : This is the stand-alone version.  It uses a separate 
  27.                resource file (PAS_XREF.RSC) and can accept a command 
  28.                line.  It will use all available memory to create the 
  29.                cross reference.
  30.  
  31.      To use PCRG, be sure to place the PRG and RSC files in the same 
  32. folder (if you are using the version with a separate resource).  There 
  33. is one dialog box that controls all functions of the program.  At this 
  34. dialog, select where the output should go :
  35.  
  36. FILE     : The xref is sent to a file with the same name as the input, 
  37.            but with an extender of .XRF.
  38.  
  39. PARALLEL : The xref is sent to a printer connected to the parallel            
  40.            port.
  41.  
  42. SERIAL   : The xref is sent to a printer connected to the serial port.
  43.  
  44.      Click on the line after the word 'filename' to select the name of 
  45. the file to cross reference.  The file selector will appear displaying 
  46. all .PAS files in the current directory.  When everything is set 
  47. correctly, click on XREF to begin the cross reference.
  48.  
  49.      A small dialog will now appear displaying the name of the file 
  50. being cross referenced and containing an abort button.  Click on the 
  51. abort button to stop the cross reference before it has finished.
  52.  
  53.  
  54.                        Other Notes and Changes
  55.  
  56. -    Works in medium and high resolution.
  57.  
  58. -    Multi-line comments do not mess up the line counts as they did in 
  59.      Mr. Garza's original version.
  60.  
  61. -    Pascal reserved words are not treated as case sensitive as they 
  62.      were in Mr. Garza's original version.  All occurences of a 
  63.      reserved word will be omitted from the cross reference regardless 
  64.      of the case.  (i.e. Begin, begin)
  65.  
  66. -    Variable and procedure names ARE case sensitive.  The variables 
  67.      'filename', 'Filename', and 'FileName' will be listed 3 different 
  68.      times.
  69.  
  70. -    Variables beginning with upper case letters are listed at the 
  71.      beginning of the cross reference.
  72.  
  73. -    Page perforations are skipped over when outputting to a printer 
  74.      and a final form feed is done at the end of the printout.
  75.  
  76. -    10 character limit on variable and procedure names has been 
  77.      removed.  The limit is now 79 characters, but names longer than 
  78.      20 characters tend to look messy. 
  79.  
  80. -    Source code has been cleaned up and more comments added.
  81.  
  82. -    Documentation has been improved.
  83.  
  84. -    An infinite number of cross references can be generated while the 
  85.      program is run because the dynamic tree that stores the cross 
  86.      reference is now erased as the xref is output.
  87.  
  88.